SocialEngine Upgrade Instructions


SOCIALENGINE 3.10+ UPGRADE INSTRUCTIONS

  1. Please also read the section below that applies to your upgrade
  2. Due to changes in the template compiler functions, you MUST clear out the contents of "include/smarty/templates_c" when upgrading
  3. Important! SocialEngine 3.10+ uses PHP sessions to keep track of users' login info (which is more secure than cookies). Unfortunately, the plugin upload pages clear out the session data. If the plugin has an upload page, and was released before 3.10, you must remove the following 3 lines from these files (if you have the corresponding plugins):
    user_album_upload.php (Albums <=3.04)
    user_blog_album_upload.php (Blogs <=3.03)
    user_event_upload.php (Events <=3.03)
    user_group_upload.php (Groups <=3.03)
    user_music_upload.php (Music <=3.03)
    user_video_upload.php (Videos <=3.01)

    Here are the lines that must be removed:
    session_start();
    $_SESSION = array();
    session_regenerate_id();

    Plugins released after 3.10 of the platform will not need this change.

SOCIALENGINE 3.02+ -> 3.X UPGRADE INSTRUCTIONS

  1. If you are upgrading from v2.8 or below, please use the instructions further down on this page. Make a COMPLETE BACKUP before you begin.
  2. Upload all of the files and folders contained in the "/files" directory in this zip to your server EXCEPT the "/uploads_user" directory. Do not upload install.html, license.html, upgrade.html, changelog.html, or the contents of the "/install" directory.
    - Upload the "/images" and "/include" directories in BINARY mode.
    - Upload everything else in ASCII mode.
    Remember, a file named "index.php" is included with SocialEngine. If you already have a homepage with this name, you can choose to not upload this file. SocialEngine also comes with an example portal page, "home.php", which you can use if desired.
    Note: If you have made modifications to your SocialEngine installation, refer to changelog.html for a list of files and language variables modified in each version. If you have made changes to those files, we suggest using WinMerge to consolidate your changes with the new files.

  3. Upload the files upgrade.php and upgradesql.php to your server. These files can be found in the "/upgrade" directory in this zip.

  4. Set full permissions (CHMOD 777) on the "/cache" directory
    Set full permissions (CHMOD 777) on the "/language" directory
    Set full permissions (CHMOD 777) on the "/language/indexes" directory
    Set full permissions (CHMOD 777) on the "/include/smarty/cache" directory
    Set full permissions (CHMOD 777) on the "/include/smarty/templates_c" directory
    Set full permissions (CHMOD 777) on every file inside the "/templates" directory

  5. Point your browser to where you uploaded upgrade.php, for example: http://www.yourdomain.com/socialnetwork/upgrade.php
    Follow the instructions given and run the upgrade script.

  6. Remember to delete "upgrade.php" and "upgradesql.php" after your upgrade has completed successfully. Leaving these files intact poses a serious security risk!


SOCIALENGINE 2.X -> 3.X UPGRADE INSTRUCTIONS

  1. If you are upgrading from v1.8 or below, you will need to upgrade to v2.X before you can upgrade to v3.00+. Make a COMPLETE BACKUP before you begin.
  2. The upgrade to 3.00 involves replacing all of your PHP, TPL, and CSS files. This means that you will lose any changes you have made to these files. Unfortunately there is no easy way to avoid this since we've made so many changes to the platform. If possible, make a note about each change you've made in your current installation so that you can reapply them after the upgrade process. Though you will not lose any user data, your users will lose their previous recent actions during the upgrade. Upload all of the files and folders contained in the "/files" directory in this zip to your server EXCEPT the "/uploads_user" and "/uploads_admin" directories. Do not upload install.html, license.html, upgrade.html, changelog.html, or the contents of the "/install" directory.
    - Upload the "/images" and "/include" directories in BINARY mode.
    - Upload everything else in ASCII mode.

  3. Upload the files upgrade.php and upgradesql.php to your SocialEngine root directory on your server. These files can be found in the "/upgrade" directory in this zip.

  4. Set full permissions (CHMOD 777) on the "/cache" directory
    Set full permissions (CHMOD 777) on the "/language" directory
    Set full permissions (CHMOD 777) on the "/language/indexes" directory
    Set full permissions (CHMOD 777) on the "/include/smarty/cache" directory
    Set full permissions (CHMOD 777) on the "/include/smarty/templates_c" directory
    Set full permissions (CHMOD 777) on every file inside the "/templates" directory
    Set full permissions (CHMOD 777) on the "/uploads_admin" directory.
    Set full permissions (CHMOD 777) on the "/uploads_admin/ads" directory.
    Set full permissions (CHMOD 777) "./include"
    Set full permissions (CHMOD 777) "./include/smarty/templates_c"
    Set full permissions (CHMOD 777) "./include/database_config.php" (if it exists)

  5. Point your browser to where you uploaded upgrade.php, for example: http://www.yourdomain.com/socialnetwork/upgrade.php
    Follow the instructions given and run the upgrade script.

  6. Remember to delete "upgrade.php" and "upgradesql.php" after your upgrade has completed successfully. Leaving these files intact poses a serious security risk!